3D Graphics Programming with QuickDraw 3D 1.5.4

Marking and Getting External References

QuickDraw 3D supplies routines you can use to manage external references from one metafile to another.

Q3File_MarkAsExternalReference

You can use the Q3File_MarkAsExternalReference function to mark an object in a metafile as being shared with another metafile.



 
TQ3Status  Q3File_MarkAsExternalReference(

                     TQ3FileObject file,

                     TQ3SharedObject sharedObject);

file: A metafile object.
sharedObject: An object in the metafile that is shared with another metafile.

DESCRIPTION

The Q3File_MarkAsExternalReference function marks the object sharedObject in the metafile object file as an object that will always be written out as an external reference. Whenever a submit call is made on the object in write loop, an external reference object will be written out that specifies the location of the object in file .

Q3File_GetExternalReferences

You can use the Q3File_GetExternalReferences function to obtain the names of files externally referred to by a metafile.



 
TQ3GroupObject  Q3File_GetExternalReferences(

                     TQ3FileObject file);

file: A metafile object.

DESCRIPTION

The Q3File_GetExternalReferences function returns the names of the files that are externally referred to by a metafile that contains external references. It returns a group that contains one Q3String object for each external reference object in the metafile. The Q3String object contains the name (in general, the pathname) of the file. Since one Q3String object is produced for each external reference, it is possible for the same name to appear in several Q3String objects. If no files are externally referred to, the call returns NULL .